How To Build SDL 2.0 for ARM


Intro


Even though I do not use this version of SDL, in this How To we are going to build SDL 2.0.1 with our GCC/G++ 4.8.2 cross-compiler. Be sure to start this build in a new terminal/tab to avoid any pollution from previous builds. Programming Linux Games is a great book for getting up to speed with SDL. Here is a interesting Linux distro that uses SDL and AGAR for playing SDL based games and much more.

Tar Balls


Here is a list of source packages that we'll need for the build. You can either download them now or wait 'til later in the How To.
  • SDL2-2.0.1.tar.gz

Create a Workspace


I recommend creating a workspace under your /home/<your user>/ directory that is dedicated to this build. So let's fire up your terminal and run the following:
$ export SDL2_SRC=~/workbench/sdl2/src
$ export SDL2_BUILD=~/workbench/sdl2/build
$ mkdir -pv ~/workbench/sdl2
$ mkdir $SDL2_SRC && mkdir $SDL2_BUILD
$ cd $SDL2_SRC

Gather the Sources


Now that we have a workspace created and we are currently in the src directory we can begin bringing down the sources and extracting them.

sdl2

$ wget https://www.libsdl.org/download-1.2.php/SDL2-2.0.1.tar.gz
$ tar -pxzf SDL2-2.0.1.tar.gz

Build Environment


To make things a little smoother let's setup some environment variables:
$ export INSTALLDIR=~/workbench/gcc-g++-4.8.2/arm
$ export PATH=$INSTALLDIR/bin:$PATH
$ export TARGETMACH=arm-none-linux-gnueabi
$ export BUILDMACH=i686-pc-linux-gnu
$ export CROSS=arm-none-linux-gnueabi
$ export CC=${CROSS}-gcc
$ export LD=${CROSS}-ld
$ export AS=${CROSS}-as
$ export CXX=${CROSS}-g++
NOTE: Depending on whether you are using a cross-compiler built from my other wikis you might need to change INSTALLDIR to point to your cross-compiler.

Build SDL2


$ cd ../build/
$ ../src/SDL2-2.0.1/./configure --prefix=/home/<your user>/workbench/sdl2/final --host=$TARGETMACH --disable-pulseaudio
 
 
!!! Need to modify the Makefile !!!
Change:
 
 
EXTRA_CFLAGS = -Iinclude -I/home/<your user>/workbench/sdl2/src/SDL2-2.0.1/include  -fvisibility=hidden -I/usr/include/dbus-1.0 -I/usr/lib/x86_64-linux-gnu/dbus-1.0/include   -D_REENTRANT -DHAVE_LINUX_VERSION_H -Wall
 
 
To:
 
 
EXTRA_CFLAGS = -Iinclude -I/home/<your user>/workbench/sdl2/src/SDL2-2.0.1/include  -fvisibility=hidden  -D_REENTRANT -DHAVE_LINUX_VERSION_H -Wall
 
 
$ make
$ make install
NOTE: I had to make the above changes for it to work for me, but you might not have to. First try the build without making the above changes to the Makefile. If it fails then try the above. Also, notice that I'm running on a 64-bit machine (builder).

Output


cd into the final directory and output its contents:
$ cd ../final/
$ ls
You should have the following directories:
  • bin
  • include
  • lib
  • share

Lastly, move the contents of these directories, or the directories themselves if they do not already exist, to your custom Linux file system or dev board. For SDL, the files should go under /usr.

Usage


To use SDL2 all you need to do is set the following in a new terminal/tab:
$ export INSTALLDIR=~/workbench/gcc-g++-4.8.2/arm
$ export PATH=$INSTALLDIR/bin:$PATH
$ export TARGETMACH=arm-none-linux-gnueabi
$ export BUILDMACH=i686-pc-linux-gnu
$ export CROSS=arm-none-linux-gnueabi
$ export CC=${CROSS}-gcc
$ export LD=${CROSS}-ld
$ export AS=${CROSS}-as
$ export CXX=${CROSS}-g++
NOTE: Depending on whether you are using a cross-compiler built from my other wikis you might need to change INSTALLDIR to point to your cross-compiler.

When you're ready to cross-compile your SDL2 program:
$ $CC -Wall -Wextra -I/home/<your user>/workbench/sdl2/final/include <your test>.c -o <your test> `/home/<your user>/workbench/sdl2/final/bin/sdl2-config --cflags --libs`
If the above does not work, then try:
$ $CC -Wl,--unresolved-symbols=ignore-all -I/home/<your user>/workbench/sdl2/final/include <your test>.c -o <your test> `/home/<your user>/workbench/sdl2/final/bin/sdl2-config --cflags --libs`